home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / di103.zip / DI.DOC next >
Text File  |  1991-01-20  |  14KB  |  330 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                     DiskInfo
  7.  
  8.                                   Version 1.03
  9.  
  10.  
  11.                       A Disk Information Utility For Ms-Dos
  12.  
  13.  
  14.                     (c) Copyright 1991, by Kenneth R. Doebler
  15.                                All Rights Reserved
  16.  
  17.  
  18.  
  19.                              released January 20, 1991
  20.  
  21.  
  22.  
  23.  
  24.  
  25.      Disclaimer - Agreement
  26.      ----------------------
  27.  
  28.      Users of DiskInfo must accept this disclaimer of warranty:
  29.  
  30.      "DiskInfo is supplied as is.  The author disclaims all warranties,
  31.      expressed or implied, including, without limitation, the warranties
  32.      of merchantability and of fitness for any purpose.  The author
  33.      assumes no liability for damages, direct or consequential, which
  34.      may result from the use of DiskInfo."
  35.  
  36.      DiskInfo is a "shareware program" and is provided at no charge to
  37.      the user for evaluation.  Feel free to share it with your friends,
  38.      but please do not give it away altered or as part of another
  39.      package or system.  The essence of "user-supported" software is to
  40.      provide personal computer users with quality software without high
  41.      prices, and yet to provide incentive for programmers to continue to
  42.      develop new products.
  43.  
  44.      If you find this program useful and find that you are using
  45.      DiskInfo and continue to use DiskInfo after a reasonable trial
  46.      period, I would ordinarily be asking that you make a registration
  47.      payment of some kind.  The registration fee would license one copy
  48.      for use on any one computer at any one time.
  49.  
  50.      Since I am not set up and ready to receive registration payments at
  51.      this time, and since this is the first utility to be released by
  52.      myself, and since this is indeed a fairly simple utility, I am at
  53.      this time waiving the usual registration fee.  However, future
  54.      versions of DiskInfo, as well as other utilities to be released,
  55.      may require a registration payment to license one copy.
  56.  
  57.      Commercial users of DiskInfo must register by contacting Ken
  58.      Doebler within 30 days of first use or their license is withdrawn.
  59.      Site-License arrangements may be made by contacting Ken Doebler.
  60.  
  61.      Anyone distributing DiskInfo for any kind of remuneration must
  62.      first contact Ken Doebler at the address listed at the end of this
  63.      document for authorization.
  64.  
  65.      You are encouraged to pass a copy of DiskInfo along to your friends
  66.      for evaluation, provided that you:
  67.  
  68.         1)  Do not modify or alter the original program or documentation
  69.             files in any way.
  70.  
  71.         2)  Pass along the complete archive with all files included,
  72.             in it's original unaltered form.
  73.  
  74.      Future releases of DiskInfo may require registration.  Registered
  75.      users of DiskInfo and other Software Resource utilities will be
  76.      granted access to special support conferences on The Software
  77.      Resource.
  78.  
  79.  
  80.      DiskInfo Overview
  81.      -----------------
  82.  
  83.      DiskInfo is a simple utility that will display information about
  84.      the current drive or the drive specified on the command line.  The
  85.      information displayed is obtained from the disk's boot sector, or
  86.      more specifically, the BIOS Parameter Block (BPB).
  87.  
  88.      While this is a very simple utility, the information displayed by
  89.      DiskInfo can often be very useful.  DiskInfo can tell you a variety
  90.      of things about a disk, including total disk space, free disk
  91.      space, cluster size, type of media, FAT type, sector and track
  92.      information, and root directory capacity just to mention a few.
  93.  
  94.      DiskInfo was written and compiled using Microsoft's BASIC 7.0 PDS
  95.      (Professional Development System) with a little additional help
  96.      from Microsoft's MASM 5.1.
  97.  
  98.  
  99.      How it works
  100.      ------------
  101.  
  102.      DiskInfo uses DOS Interrupt 25h (Absolute Disk Read) to read the
  103.      disk's boot sector into memory, where it then deciphers most of the
  104.      information it displays.  Prior to doing this, DI also scans your
  105.      root directory to obtain the volume label information and makes a
  106.      call to DOS Interrupt 21h, Function 36h to obtain the amount of
  107.      disk free space available, along with a few other necessary DOS
  108.      calls to determine valid drives and so on.
  109.  
  110.  
  111.      Usage Syntax
  112.      ------------
  113.  
  114.      DiskInfo can be invoked in one of two ways as follows:
  115.  
  116.      1)  DI
  117.  
  118.      2)  DI <drive> or <drive:>
  119.  
  120.      If DiskInfo is invoked without any command line arguments (1) then
  121.      DI will report information on the currently logged (default) drive.
  122.      No other command line arguments are available.  DI will accept all
  123.      valid drive letters, upper or lowercase, from A-Z, with or without
  124.      an appended colon.
  125.  
  126.  
  127.      Information Displayed
  128.      ---------------------
  129.  
  130.      DiskInfo displays a full screen of information about the selected
  131.      disk as described below:
  132.  
  133.  
  134.      Volume Label          : The disk's volume label.  If no volume
  135.                              label is present, DI will display "None"
  136.                              in this field.
  137.      Media Type            : The type of disk, for example, single
  138.                              sided floppy, double sided floppy, fixed
  139.                              disk (hard disk), and so on.
  140.      OEM ID                : The system name field.  This field
  141.                              identifies the manufacturer whose system
  142.                              formatted the disk.  Some manufacturers do
  143.                              not put a name here.
  144.      Total Space           : Total disk space in bytes.
  145.      Space Used            : Allocated disk space occupied by files.
  146.      Space Available       : Free disk space available and unallocated.
  147.      Bytes Per Sector      : Indicates your sector size in bytes.  This
  148.                              should always be 512 for DOS disks.
  149.      Total Disk Sectors    : Indicates the total number of usable
  150.                              sectors on the disk, regardless of whether
  151.                              they are free, used or marked bad by DOS.
  152.                              Usable refers to sectors which are
  153.                              theoretically available to DOS for file
  154.                              allocation.
  155.      Bytes Per Cluster     : Indicates the disk's cluster size in bytes.
  156.                              This value can vary depending upon how the
  157.                              disk was formatted.
  158.      Total Disk Clusters   : Indicates total disk clusters available for
  159.                              file allocation.
  160.      Sectors Per Cluster   : The number of sectors per cluster.  This
  161.                              can vary depending upon the disk format.
  162.      Reserved Sectors      : The number of sectors reserved by DOS and
  163.                              not available for use.
  164.      Sectors Per Track     : The number of sectors per disk track.
  165.      Total Cylinders       : The total number of cylinders (or tracks)
  166.                              on the disk.
  167.      Hidden Sectors        : Total number of hidden sectors on the disk.
  168.      Root Dir Sectors      : The number of sectors allocated to the
  169.                              disk's root directory.  This is fixed and
  170.                              set when the disk is formatted.
  171.      Root Starting Sector  : The starting sector number for the disk's
  172.                              root directory.
  173.      Maximum Root Entries  : The maximum number of directory entries
  174.                              which the root directory can hold.
  175.      Sectors Per FAT       : The size in sectors of one copy of the
  176.                              disk's FAT (File Allocation Table).
  177.      Number Of FATs        : The number of copies of the disk's FAT.
  178.                              This is typically 2, however more copies
  179.                              are possible.
  180.      Total FAT Sectors     : Total number of disk sectors occupied by
  181.                              copies of the FAT.
  182.      Bits Per FAT Entry    : The number of bits in one FAT en